home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 5 / Amiga Plus Sonderheft 1996 #5.iso / programme / xipaint3.2 / xipaint.lzx / XiPaintModule / hhsxipaintmod.readme < prev    next >
Text File  |  1983-02-10  |  16KB  |  350 lines
  1. HHsFastUniversalXiPaintModule 4.2 (incl. PhotoCD- & TrueColorAnim-support)
  2. =================================
  3.  
  4. new in V4.x: Downscaled loading support: Loading big pictures in downscaled
  5.         form can save much memory and time. Finally a way to get
  6.         your "too big" pictures into XiPaint...
  7.     Included JPeg support (esp. useful e.g. for downscaled loading)
  8.     Automatic installation script added.
  9. new in V3.0: TrueColor animation saving support in HHsYUVSq animation format
  10.     ->create your own TrueColor animations for playback on CyberGraphX
  11.       with CyberTVPlayer or on EGS with EGSTVPlayer <-
  12.     Including ARexx script for automatic conversion of picture
  13.       directories into HHsYUVSq animation format
  14.  
  15. This universal module can be used to load images in many file formats
  16. (more than 20 and additionally Datatypes) very fast into XiPaint (including
  17. optional downscaling) and to create TrueColor animations in HHsYUVSq
  18. animation format.
  19.  
  20. Installation
  21. ------------
  22.  
  23. The module can be installed automatically with the included script: Simply
  24. start it and select the XiPaint main directory in the file requester. The
  25. needed files will then be installed.
  26.  
  27. If you prefer manual installation: "hhsxipaintmod.xio" is the main module
  28. and should be copied to the XiPaint/Modules directory for XiPaint 3.2 and up.
  29. For older versions the module should be copied to the XiPaint main directory
  30. and the additional ARexx script "hhsxipaintloader.rx" should come into
  31. the XiPaint/Makro directory. For all versions the "makeanim.rx" script can
  32. be installed in the XiPaint/Makro or XiPaint main directory.
  33.  
  34. Usage
  35. -----
  36.  
  37. 1) XiPaint 3.2 or higher (incl. XiPaint 4.x): The module will be detected
  38.    by XiPaint
  39.  
  40.   a) as "HHsUniversalLoader", "Universal_50%_size" and "Universal_25%_size"
  41.      which you can then select in the Settings/Loaders list of loader
  42.      modules. The Loader will be automatically used (if selected) for
  43.      opening of new projects and for loading into existing projects.
  44.      To load pictures in half or quarter size, use the %_size loaders.
  45.  
  46.   b) as "HHsYUVSqAnimation" which you can then select in the Settings/Savers
  47.      list of saver modules. To create a new animation, select a new filename
  48.      for saving with this format; to append a frame to an existing animation,
  49.      select the existing animation file for saving. XiPaint will warn you
  50.      that the file is overwritten, but the module will only append the frame
  51.      and not delete the old file.
  52.  
  53.      Please note: Image width must be in the range 80 to 360 (even size will
  54.      be generated); Image height must be in the range 64 to 310. To append
  55.      frames to an animation, the image size in XiPaint must match the frame
  56.      size of the file you want to append to. Otherwise (or if you specify
  57.      not a HHsYUVSq anim file) an error will occur.
  58.  
  59.    To automatically create an animation from a directory of pictures you
  60.    can use the included ARexx script "makeanim.rx". This will do automatic
  61.    downscaling. Please see notes below.
  62.  
  63.    The module has been tested with XiPaint 3.2 and the new XiPaint 4.0!
  64.  
  65. -> XiPaint-CD: If you have problems with XiPaint on CD-ROM,
  66.    you should check your file system; some CD file systems
  67.    only support upper case file names; XiPrefs looks only for
  68.    lower case xout-libraries; use another file system or rename
  69.    the libraries to lowercase manually (on your harddisk) like
  70.    rename XiPaint/libs/XOUT_C.LIBRARY "XiPaint/libs/xout_c.library"
  71.    etc... This should solve your problems.
  72.  
  73. 2) XiPaint 3.0/3.1
  74.  
  75.   As thoose XiPaint versions have no direct support for external modules,
  76.   you can only access it by the included ARexx scripts.
  77.  
  78.   a) For loading: Execute the "hhsxipaintloader.rx" macro (with the
  79.      menu function Macro/Execute).
  80.      It will then switch to the WB screen and display a standard
  81.      file requester. You can then select a file for loading. The
  82.      picture will be loaded if possible and transferred to XiPaint
  83.      as a new project window. Then the WB screen is sent back so
  84.      that XiPaint screen should appear in front again. Some XiPaint
  85.      versions add absolute path names of new project windows to the
  86.      relative standard path. I can't work around this, so such
  87.      pictures will get wrong project names with such versions (Only
  88.      use SaveAs to save such pictures). Please upgrade to XiPaint 3.2
  89.      to get a more convenient access to my module...
  90.  
  91.   b) For TrueColor animation creation: Execute the automatic script
  92.      "makeanim.rx"; see below for details.
  93.  
  94. Supported file formats
  95. ----------------------
  96.  
  97. Supported file formats for loading:
  98.  
  99. * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  100. * JPeg (color and greyscale; see notes below)
  101. * PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
  102. * PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  103. * QRT (also known as dump format by PD raytracers as POV-Ray)
  104. * Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
  105. * PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  106. * MacPaint (b&w compressed 1Bit format; datafork only)
  107. * BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  108. * TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  109. * EGS7.x window iconification file format
  110. * DEEP (compr.&uncompr. 24Bit and 32Bit)
  111. * RGB formats (RGB8, RGBN, RGB5)
  112. * ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
  113. * FBM formats (8Bit grey/color and 24Bit)
  114. * IFF-PBM (DPII) format
  115. * Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
  116. * YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  117. * VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  118. * HHsYUVSq sequence format (sequential or random access; only first frame)
  119. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  120. * binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  121. * TBCPlus frames&fields
  122.  
  123. * DataType (incl. first frame of animations with Anim-Datatypes)
  124.  
  125. Supported file formats for saving:
  126.  
  127. * HHsYUVSq animation format
  128.  
  129. Automatic creation of HHsYUVSq TrueColor animations
  130. ---------------------------------------------------
  131.  
  132. With the script "makeanim.rx" you can automatically convert a directory
  133. of pictures into an HHsYUVSq animation file. Just start the script
  134. from XiPaint as macro or from Workbench or Shell. It should work with
  135. all XiPaint 3.x and up versions. If you start it from XiPaint, you will
  136. probably have to switch to WB screen manually; there you get a requester
  137. asking for the source directory which should contain the pictures
  138. (all of the same size). Then you are asked for the destination animation
  139. file. Then the automatic conversion is started. Pictures are downscaled
  140. if necessary. You can watch the pictures beeing loaded in XiPaint. They
  141. are loaded in alphabetical order (users of old XiPaint versions prior to
  142. V3.2 should NOT play with XiPaint during this process as this can
  143. block the whole system). With newer versions it should be save to
  144. use XiPaint for other things during the process except loading as
  145. this would interact with the frame loading! If the conversion has finished,
  146. the last picture will remain in XiPaint as a project. You can close
  147. this manually.
  148.  
  149. To play the animations use my freeware player programs
  150. CyberTVPlayer for TrueColor playback on CyberGraphX compatible
  151. boards (incl. Draco) or EGSTVPlayer for TrueColor playback on
  152. EGS compatible boards. CyberTVPlayer can also be used without
  153. CyberGraphX for reduced viewing (upto 256 colors) on all Amigas
  154. with at least OS3.0.
  155.  
  156. Additional notes: The loading/saving is done with HHsXiPaintMod.xio
  157. only; so you can only load pictures in one of the supported formats
  158. (see above). If you want to make animations from pictures in other formats,
  159. you have to load and save them with the appropriate modules manually.
  160. But anyway, the module now seems to support nearly all formats...
  161.  
  162. Downscaled loading
  163. ------------------
  164.  
  165. The loader module now supports direct downscaled loading in XiPaint 3.2
  166. and higher; simply select the appropriate loader version in the list.
  167. Currently the loader should appear 3 times: HHsUniversalLoader for full
  168. size, Universal_50%_Size for half size and Universal_25%_Size for quarter
  169. size. For most file formats (e.g. IFF, DEEP, JPeg, PCX, PPM, Targa, ...)
  170. the downscaling is done on a line by line base, so that memory will only
  171. be needed for the reduced size. This should enable you to get big
  172. pictures into XiPaint without memory problems.
  173.  
  174. General notes
  175. -------------
  176.  
  177. There are currently no error requesters for loading (if a file can not be
  178. loaded nothing will happen). For saving error requesters are included.
  179.  
  180. If you register for the XiPaint modules you will receive a
  181. keyfile together with the latest version of the modules. The
  182. keyfile will enable you to use future demo versions as update.
  183.  
  184. The demo version will load and save all pictures in greyscales, but
  185. usually at the same speed as the full version would do in color.
  186.  
  187. XiPaintModules need at least OS2.04 (OS3.x for Datatype usage).
  188.  
  189. All loading functions (except JPeg: This software is based in part on the work
  190. of the independent JPeg Group) have been written in Assembler and optimised for
  191. extremely high speed. An exception to this is the JPeg format, which is
  192. written in C and based on the usual code of the indipendent JPeg group.
  193. I created the fast loading functions mainly for my famous shareware programs
  194. *** CyberShow Professional *** (universal viewer and slideshow program
  195. for all OS3.x Amigas and Dracos and esp. for CyberGraphX users), EGSPhotoAlbum
  196. Prof. and EGS-TV Prof.; When new formats are implemented for my other
  197. programs (or the speed is improved further), I will usually also update
  198. the modules, which registered user can then use due to the keyfile concept.
  199.  
  200. The JPeg format has been included in this module mainly for the comfort
  201. of the users (as otherwise for JPeg another loader module would have to
  202. be seleted) and to enable JPeg loading in downscaled form, which can be
  203. very useful. Now you can also create animations in HHsYUVSq animation
  204. format from JPeg pictures with the automatic ARexx script. The loading
  205. speed of the JPeg code (for pictures in full size) is unfortunately
  206. currently not very fast. Downscaled loading of JPeg can be much faster.
  207.  
  208. Registration
  209. ------------
  210.  
  211. You can register for the module at the small add-on price of only 8US$ or
  212. 10DM if you order it together with one of my other shareware programs,
  213. e.g. CyberShow, the universal viewer and slideshow program for all Amigas
  214. with at least OS3.0 (loading the same formats as the XiPaintModule and
  215. additional JPeg) or EGSPhotoAlbum or EGS-TV. Please use the registration
  216. forms of thoose programs and specify your add-on module order there and
  217. include the extra amount.
  218.  
  219. Otherwise you should use the included registration form to register:
  220.  
  221. If you only want to register for the module, the registration fee is
  222. 18US$ outside europe or 20DM in europe. You will also get the latest demo
  223. versions of my other programs. Additional modules (e.g. UniversalGIO for
  224. Photogenics or FastIFXModules for ImageFX) can be ordered at the lower
  225. add-on price.
  226.  
  227. If you are already a registered user of one of my programs and now want to
  228. register for the modules, the registration fee is 13US$ outside europe or
  229. 15DM (in europe). This includes the latest versions of my programs as update.
  230. Additional modules (e.g. UniversalGIO for Photogenics or FastIFXModules for
  231. ImageFX) can be ordered at the lower add-on price.
  232.  
  233. (Special note for users in germany only: Wenn Sie schon registrierter Benutzer
  234.  eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
  235.  geändert hat, können Sie die Module direkt per Überweisung bestellen.
  236.  Als Verwendungszweck geben Sie bitte "XiPaintMod für ...." an, wobei Sie
  237.  das Programm was Sie schon haben und die Registriernummer angeben.
  238.  Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
  239.  Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
  240.  (No bank transfers from outside germany!)
  241.  
  242. Send your filled in registration form together with cheque, international
  243. postal money order or banknotes to:
  244.  
  245.                         Helmut Hoffmann
  246.             Rubensstrasse 4
  247.             D-41063 Mönchengladbach
  248.  
  249.             Germany
  250.  
  251. You can currently also contact me by EMail (e.g. for suggestions):
  252.  
  253.         hhoff@pool.informatik.rwth-aachen.de
  254.  
  255. No registrations by EMail! If you want to register, please write by ordinary mail
  256. to my address above.
  257.  
  258. Special Thanks
  259. --------------
  260.  
  261. My special thanks go to Mr. Thomas Dorn and Ossowski's Schatztruhe for
  262. providing me with XiPaint.
  263.  
  264. Disclaimer
  265. ----------
  266.  
  267. This software (program and documentation) is provided "as is" and
  268. comes with no warranty, either expressed or implied.
  269. The author is in no way responsible for any damage or loss that may
  270. occur due to direct or indirect usage of this software. You use
  271. this software entirely at your own risk.
  272.  
  273. Copyright and Distribution
  274. --------------------------
  275.  
  276. HHsFastUniversalXiPaintModule (module and documentation) is copyright by
  277.  
  278.                         Helmut Hoffmann
  279.             Rubensstrasse 4
  280.             D-41063 Mönchengladbach
  281.  
  282.             Germany
  283.  
  284. The demo version may be freely distributed and used as
  285. long as the following conditions are met:
  286.  
  287. 1) All files have to be kept together
  288.  
  289. 2) No file may be modified or crunched/packed.
  290.  
  291.    The only official way to distribute the demo packed is the
  292.    original xipaintmod.lha archive.
  293.    The modules may not be disassembled or analysed. The limitations
  294.    integrated in the demo version may under no circumstance be removed
  295.    or bypassed.
  296.  
  297. 3) Distributors may only charge for the duplication process (including media)
  298.    and not for the software. Theese charges may not exceed the following
  299.    limits: a) Demo on a PD-disk: 7$ (US-dollar) including
  300.               postage&packing (in Germany: 10DM)
  301.        b) Demo on a PD-CD-ROM: 40$ (US-dollar) including
  302.               postage&packing (in Germany: 60DM)
  303.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  304.               callable system: Maximum charge 3$ (US-dollar) (in Germany: 5DM)
  305.               for downloading
  306.    Anyway, it must be made explictly clear to the buyer, that he does not
  307.    pay for the modules (demo) itself but only for the duplication service.
  308.  
  309. 4) It is not allowed to distribute this demo with any commercial product
  310.    without a written permission by me. One exception is the distribution of
  311.    the demo version with products not exceeding the above price limits (e.g.
  312.    a cover-disk magazine for 7$ or less).
  313.  
  314.    The demo version may be included with XiPaint.
  315.  
  316. 5) The registered version may not be redistributed. It may only run on one
  317.    machine per registration. It is allowed to make a backup copy of the
  318.    original disk.
  319.  
  320. Version history
  321. ---------------
  322.  
  323. V0.1 (7th aug. 95): Prerelease for loading functions
  324. V0.2 (20th aug. 95): Prerelease for loading by ARexx script:
  325.             added Request option and screen switching functions
  326. V1.0 (15th sep. 95): First official release for use by Arexx script (usable
  327.             with XiPaint 3.x)
  328. V2.0 (21st sep. 95): First release with direct loader module support for
  329.             XiPaint 3.2 (just copy the .xio file into the
  330.             XiPaint/Modules directory and configure it as loader)
  331. V2.1 (9th oct. 95): Extended TIF loader to support "Intel" byte order files
  332.             and more variants
  333. V3.0 (11th dec. 95): TrueColor animation saving: extended module to support
  334.             saving in HHsYUVSq animation format;
  335.             included ARexx script to automatically create such
  336.             animations from multiple pictures
  337.              Extended IFF loader to accept 0-sized chunks
  338.              Loader can now load bigger pictures into smaller projects
  339.              Integrated downscaling support (only usable by scripts)
  340. V4.0 (9th feb. 96): Support for downscaled loading (50% size, 25% size) by
  341.             additional entries in the XiPaint 3.2 loader list
  342.             Added JPeg loading support (see special notes for JPeg!)
  343.             Included script for automatic installation of modules
  344.             Bug fixes in makeanim.rx script: now should also work
  345.             if other project windows exist during anim creation
  346.             Extended IFF loader to accept unusual sized color maps
  347. V4.1 (24th march 96): Changed PCX loading for more compatibility
  348. V4.2 (2nd april 96): Extended PCX loading for even more compatibility
  349.  
  350.